docs: try harder to suppress missing link warnings

diff --git a/docs/reference/gtk/getting_started.xml b/docs/reference/gtk/getting_started.xml
index c064365dbef65b23fb752c844ad9e97149a721e6..3cef084ed11710c1069cd0e3316bcfc86eba4f10 100644 (file)
--- a/docs/reference/gtk/getting_started.xml
+++ b/docs/reference/gtk/getting_started.xml
@@ -419,7 +419,7 @@ example_app_window_class_init (ExampleAppWindowClass *class)
         <para>(<ulink url="https://git.gnome.org/browse/gtk+/tree/examples/application2/exampleappwin.c">full source</ulink>)</para>
       </informalexample>
 
-      <para>You may have noticed that we used the <literal>_from_resource()</literal> variant
+      <para>You may have noticed that we used the <literal>_from_resource(<!-- -->)</literal> variant
       of the function that sets a template. Now we need to use GLib's resource
       functionality to include the ui file in the binary. This is commonly
       done by listing all resources in a .gresource.xml file, such as this:
@@ -720,7 +720,7 @@ example_app_window_init (ExampleAppWindow *win)
         <programlisting><xi:include href="../../../../examples/application6/exampleappprefs.c" parse="text"><xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback></xi:include></programlisting>
       </informalexample>
 
-      <para>Now we revisit the <literal>preferences_activated()</literal> function in our
+      <para>Now we revisit the <literal>preferences_activated(<!-- -->)</literal> function in our
       application class, and make it open a new preference dialog.</para>
 
       <informalexample>

diff --git a/docs/reference/gtk/question_index.sgml b/docs/reference/gtk/question_index.sgml
index b74b26f9b89c5c5c85df4295e9b83ec4dddb1f48..f0e11b7a21daa41d8cc8364b2da14b34286567e5 100644 (file)
--- a/docs/reference/gtk/question_index.sgml
+++ b/docs/reference/gtk/question_index.sgml
@@ -186,9 +186,9 @@ or Linux system with gettext installed, type <literal>info gettext</literal>
 to read the documentation.
 </para>
 <para>
-The short checklist on how to use gettext is: call <literal>bindtextdomain()</literal> so
+The short checklist on how to use gettext is: call <literal>bindtextdomain(<!-- -->)</literal> so
 gettext can find the files containing your translations, call textdomain()
-to set the default translation domain, call <literal>bind_textdomain_codeset()</literal> to
+to set the default translation domain, call <literal>bind_textdomain_codeset(<!-- -->)</literal> to
 request that all translated strings are returned in UTF-8, then call
 gettext() to look up each string to be translated in the default domain.
 </para>
@@ -360,7 +360,7 @@ g_free (text);
 </para>
 <para>
 If you are using gettext() to localize your application, you need to
-call bind_textdomain_codeset() to ensure that translated strings are
+call <literal>bind_textdomain_codeset(<!-- -->)</literal> to ensure that translated strings are
 returned in UTF-8 encoding.
 </para>
 </answer>
@@ -522,7 +522,7 @@ macro ?
 <answer>
 <para>
 The <literal>GTK_TYPE_BLAH</literal> macros are defined as calls to
-<literal>gtk_blah_get_type()</literal>, and the <literal>_get_type()</literal> i
+<literal>gtk_blah_get_type(<!-- -->)</literal>, and the <literal>_get_type(<!-- -->)</literal> i
 functions are declared as %G_GNUC_CONST which allows the compiler to optimize
 the call away if it appears that the value is not being used.
 </para>